Skip to content

Add ContextMatic Plugin#1166

Open
mohammadali2549 wants to merge 20 commits intogithub:stagedfrom
apimatic:add-context-matic-plugin
Open

Add ContextMatic Plugin#1166
mohammadali2549 wants to merge 20 commits intogithub:stagedfrom
apimatic:add-context-matic-plugin

Conversation

@mohammadali2549
Copy link
Copy Markdown

@mohammadali2549 mohammadali2549 commented Mar 25, 2026

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • I have read and followed the Guidance for submissions involving paid services.
  • My contribution adds new a plugin and skills in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.
  • I am targeting the staged branch for this pull request.

Description

This pull request adds a new context-matic plugin to Awesome Copilot, along with two supporting skills and the related generated marketplace and README updates.

The plugin integrates APIMatic's hosted ContextMatic MCP server so GitHub Copilot can retrieve version-aware API and SDK context at runtime instead of relying on generic or outdated examples from model training data. This is aimed at third-party API integration scenarios where correctness depends on the exact API surface, authentication flow, model definitions, and endpoint contracts.

What this PR adds

  • A new context-matic plugin definition and marketplace registration
  • A plugin-level .mcp.json that registers the hosted ContextMatic MCP server
  • A plugin README explaining the workflow, supported APIs, tools, and usage examples
  • A new integrate-context-matic skill for end-to-end third-party API integration workflows
  • A new onboard-context-matic skill for first-time discovery and guided onboarding
  • Generated documentation updates in the plugin and skill README indexes

Why this is being added

When developers ask Copilot to integrate an external API, models often have to guess based on outdated training data or public examples that may be stale, incomplete, or mismatched to the actual SDK version in use. ContextMatic addresses that gap by grounding the agent in authoritative, SDK-native API context exposed through MCP tools.

This makes the agent more useful for API integration scenarios.

Benefits

  • Significantly reduces token usage when compared with integration without ContextMatic
  • Reduces hallucinated or outdated API usage patterns
  • Improves accuracy for authentication, endpoint selection, and request/response model usage
  • Gives users a clearer workflow for discovering supported APIs and integrating them correctly
  • Helps first-time users understand what the MCP server can do and how to use it effectively
  • Expands the Awesome Copilot plugin marketplace with a practical third-party API integration toolkit

Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • Update to existing instruction, prompt, agent, plugin, skill, or workflow.
  • Other (please specify):

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

Copilot AI review requested due to automatic review settings March 25, 2026 12:34
@mohammadali2549 mohammadali2549 changed the title Integrate ContextMatic Plugin Add ContextMatic Plugin Mar 25, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new ContextMatic plugin to Awesome Copilot, providing an MCP server configuration plus two skills (onboarding + integration) and registering the plugin/skills in the repository’s generated docs and marketplace metadata.

Changes:

  • Introduces two new skills: /integrate-context-matic and /onboard-context-matic.
  • Adds a new plugins/context-matic/ plugin with README, MCP server config, and plugin metadata.
  • Updates skills/plugins indices and marketplace listing to include the new additions.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 7 comments.

Show a summary per file
File Description
skills/onboard-context-matic/SKILL.md New interactive onboarding/tour skill for the ContextMatic MCP server.
skills/integrate-context-matic/SKILL.md New workflow skill intended to guide end-to-end third-party API integration via ContextMatic tools.
plugins/context-matic/README.md Plugin documentation describing tools, supported APIs, and usage examples.
plugins/context-matic/.mcp.json MCP server registration/config for the plugin.
plugins/context-matic/.github/plugin/plugin.json Plugin metadata (name/description/version/keywords/skill references).
docs/README.skills.md Adds the two new skills to the skills index table.
docs/README.plugins.md Adds the new plugin to the plugins index table.
.github/plugin/marketplace.json Registers the plugin in the marketplace list used by tooling/CI.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@mohammadali2549 mohammadali2549 marked this pull request as draft March 25, 2026 12:43
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 31, 2026

🔍 Skill Validator Results

3 resource(s) checked | ✅ All checks passed

Full output
Found 2 skill(s)
[integrate-context-matic] 📊 integrate-context-matic: 1,412 BPE tokens [chars/4: 1,495] (detailed ✓), 12 sections, 0 code blocks
[integrate-context-matic]    ⚠  No code blocks — agents perform better with concrete snippets and commands.
[integrate-context-matic]    ⚠  No numbered workflow steps — agents follow sequenced procedures more reliably.
[onboard-context-matic] 📊 onboard-context-matic: 3,039 BPE tokens [chars/4: 3,261] (standard ~), 13 sections, 12 code blocks
[onboard-context-matic]    ⚠  Skill is 3,039 BPE tokens (chars/4 estimate: 3,261) — approaching "comprehensive" range where gains diminish.
�[32m✅ All checks passed (2 skill(s))�[0m

mohammadali2549 and others added 2 commits March 31, 2026 11:11
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 6 comments.

mohammadali2549 and others added 7 commits March 31, 2026 12:34
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@mohammadali2549 mohammadali2549 marked this pull request as ready for review March 31, 2026 09:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants